SetAnimatedThemeCursor

Animates a version of the specified cursor type that is consistent with the current theme.

pascal OSStatus SetAnimatedThemeCursor (
ThemeCursor inCursor,
UInt32 inAnimationStep);

inCursor

A value of type ThemeCursor . Pass a constant specifying the type of cursor to set; see Theme Cursor Constants for a description of the possible values. Note that only cursors designated as able to be animated should be used for this function. If you specify an unanimatable cursor type, SetAnimatedThemeCursor returns the error themeBadCursorIndexErr (-30565).

inAnimationStep

An unsigned 32-bit value. Pass a value specifying the current animation step of the cursor. To animate the cursor, increment the value by 1 with each call to SetAnimatedThemeCursor .

function result

A result code; see Result Codes .

DISCUSSION

Appearance Manager 1.1 introduces cursors that can change appearance with a theme change. In order to be theme-compliant, your program should use these theme-specific cursors whenever possible, instead of the classic black-and-white cursors.

Your application should call the SetAnimatedThemeCursor function to ensure that its animated cursors are theme-compliant, rather than using any QuickDraw cursor utilities functions such as SetCursor , SetCCursor , SpinCursor , or RotateCursor . If you wish a non-animated cursor to be theme-compliant, call the function SetThemeCursor .

Because these are color cursors, they currently cannot be set from interrupt time. Therefore, if you support animated cursors that are changed at interrupt time you should continue to use your own cursors for now.

SPECIAL CONSIDERATIONS

Do not call SetAnimatedThemeCursor at interrupt time.

VERSION NOTES

Available with Appearance Manager 1.1 and later.

SetAnimatedThemeCursor

DISCUSSION

SPECIAL CONSIDERATIONS

VERSION NOTES

SEE ALSO